home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / Reference / DevCon / Orlando_1993 / Devcon93.2 / AVPlayer / AVPlayer.doc < prev    next >
Encoding:
Text File  |  1992-12-31  |  10.1 KB  |  260 lines
  1.  
  2. THE AMIGAVISION PLAYER: AVPLAYER, release 2.04
  3.  
  4. (c) Copyright 1992 Commodore-Amiga, Inc.  All Rights Reserved.
  5.  
  6.  
  7. AVPlayer, avdb.library, avtextgad.library, camd.library,
  8. realtime.library, and associated documentation and icons are
  9. (c) Copyright 1992 Commodore-Amiga, Inc.  All Rights Reserved.
  10.  
  11. THIS SOFTWARE AND/OR INFORMATION IS PROVIDED "AS-IS".  NO
  12. REPRESENTATIONS OR WARRANTIES ARE MADE, AND ALL USE IS AT YOUR OWN
  13. RISK.  NEITHER COMMODORE NOR THE AUTHORS ASSUME ANY RESPONSIBILITY
  14. OR LIABILITY WHATSOEVER.
  15.  
  16. This archive contains a freely redistributable player program
  17. called AVPlayer. AVPlayer is a version of AmigaVision Professional
  18. without the Flow Editor. It allows you to play back flows created
  19. in AmigaVision Professional or AmigaVision 1.7.
  20.  
  21. This archive may be distributed provided the following rules are
  22. complied with:
  23.     A) No change may be made to the AVPlayer, its libraries or
  24.        documentation.
  25.     B) AVPlayer and its associated libraries may not be installed on
  26.        a user's system or Workbench unless the installation procedure
  27.        included with the distributed product has determined that
  28.        the user's system or Workbench does not include more recent
  29.        versions of these files.
  30.     C) The AVPlayer must be distributed in its complete form,
  31.        containing the 8 files listed below:
  32.                 1) AVPlayer, version 2.4
  33.                 2) AVPlayer.info
  34.                 3) AVPlayer.doc
  35.                 4) AVPlayer.doc.info
  36.                 5) avdb.library, version 2.2
  37.                 6) avtextgad.library, version 1.1
  38.                 7) camd.library, version 37.13
  39.                 8) realtime.library, version 37.3
  40.  
  41.  
  42. AmigaVision Professional is an icon-based authoring tool for
  43. creating presentations, point-of-information displays and
  44. interactive courseware. It is compatible with AmigaVision version
  45. 1.7. Among its many new features are: CDTV support, playback of CD
  46. Digital Audio and CD-XL Motion Video files, multi-dimensional
  47. arrays, streamed-in animation and sound files, ANIM Brush support,
  48. more screen transitions, V39 compatibility and AA graphics support.
  49.  
  50.  
  51. USING AVPLAYER
  52.  
  53. To use the AmigaVision player program, enter the following from the
  54. AmigaDOS CLI:
  55.  
  56.               AVPlayer <filename.AVf> [-sXXXXX]
  57.  
  58. The first parameter, the AmigaVision file to be presented, should
  59. contain the file's complete path, and the .AVf extension. For
  60. example:
  61.  
  62.               AVPlayer MyDisk:examples/Quiz.avf
  63.  
  64. The second optional parameter overrides the default stack size.
  65. When the AVPlayer is started, it sets a default stack size of 20K.
  66. To override this stack size, specify the "-s" parameter followed by
  67. a number which represents the new stack size.  For example:
  68.  
  69.               AVPlayer MyDisk:examples/Quiz.avf -s10000
  70.  
  71. will cause the AVPlayer to set a stack size of 10K.
  72.  
  73. Before the AVPlayer creates its stack, it will check the system
  74. stack. If the system stack is the larger than the stack that
  75. AVPlayer wants to create, a new stack will not be created, the
  76. system stack will be used instead. If the system stack is smaller
  77. than the one that AVPlayer wants to create, a second stack will be
  78. created for the AVPlayer.
  79.  
  80. This version of the AmigaVision player cannot be run from Workbench.
  81.  
  82. This version of the player has been divided into three portions:
  83.  
  84.     AVPlayer          : the main executable, and
  85.     avdb.library      : a library containing all AV's database
  86.                         functionality,
  87.     avtextgad.library : a library containing all AV's input field
  88.                         form functionality.
  89.  
  90. The optional libraries are needed only if the flow contains icons
  91. from the Data sub-menu. They are intended to be placed in the Libs:
  92. directory or in the same directory as AVPlayer.  As they are
  93. specific to AmigaVision, we recommend that they be stored with the
  94. executable.
  95.  
  96. Camd.library and realtime.library must be present in the Libs:
  97. directory if you plan to play MIDI files with AmigaVision. If you
  98. have copies of these libraries that are older than those in the
  99. AVPlayer archive, use the libraries from the AVPlayer archive.
  100.  
  101. You can determine the version number of your libraries by using the
  102. version command. For example,
  103.  
  104.               version libs:camd.library
  105.  
  106. will return the version number of the camd.library file in your
  107. LIBS: directory.
  108.  
  109.  
  110. RUNNING THE AVPLAYER FROM A PROJECT ICON
  111.  
  112. To play an AmigaVision flow from a Workbench icon, the following
  113. procedure may be used:
  114.  
  115. 1. Create a Project-type icon (same type as an AmigaVision Flow
  116.    icon). For this explanation the Project icon will be called
  117.    "RunFlow.info".
  118.  
  119. 2. Set the Default Tool of the Project icon to c:IconX. Do this by
  120.    selecting the Project icon, and then choosing Information or
  121.    Info from the Workbench menu. Enter "c:IconX" in the Default
  122.    Tool, and then select Save.
  123.  
  124. 3. Use a text editor to create a text script file as follows,
  125.    substituting the path and name of your AmigaVision flow.
  126.  
  127.    Sample script file:
  128.  
  129. .key none
  130. .bra {
  131. .ket }
  132. MyDisk:AVPlayer MyDisk:examples/Quiz.avf
  133.  
  134. 4. Save the text script file in the same directory as your Project
  135.    icon and with the same name as the icon minus the ".info". So,
  136.    if your Project icon is called "RunFlow.info", then the text
  137.    script file must be saved as "RunFlow".
  138.  
  139. 5. Now, if you double-click your Project icon, IconX will execute
  140.    your script.
  141.  
  142.  
  143. =======================================================================
  144.  
  145. ERROR REQUESTER CODES
  146.  
  147. 1007  Amiga is low on memory; Please free some and try again.
  148. 1010  Screen resolution and interlace settings of consecutive pictures
  149.       must be the same to perform specified transition.
  150.       (Fade transitions will work)
  151. 1022  Warning: Insufficient or Fragmented memory!  Free Memory and hit
  152.       Continue to try again, or Cancel to Abort AmigaVision.
  153. 1023  Operation could not be performed as specified.
  154.       Select:
  155.       Continue: to continue presentation
  156.       Cancel: to terminate presentation.
  157. 1026  Evaluation was terminated due to lack of memory.
  158. 2002  Insufficient memory.
  159. 2008  Cannot open file specified.
  160. 2009  Specified file is not of IFF format.
  161. 2010  Cannot open screen.
  162. 2011  Cannot open window.
  163. 2012  Video Error: Cannot open Devs:Player.device.  Please install
  164.       proper driver software.
  165. 2014  Type Mismatch of variables in expression.
  166. 2015  Syntax error. Please refer to the User's Manual.
  167. 2016  Incomplete expression.
  168. 2017  Numeric operation on a string or a boolean variable is not allowed.
  169. 2018  Divide by zero. Please check variable values.
  170. 2020  String table overflow.
  171. 2021  Incorrect parameter type.
  172. 2022  Incorrect number of parameters.
  173. 2023  Variable name too long.
  174. 2025  Unknown variable. Please define variable before using...
  175. 2027  Field name is empty or contains illegal characters.
  176. 2028  No Fields specified for Database.
  177. 2029  Cannot insert - Record length would exceed maximum size of 4000
  178.       Characters.
  179. 2031  Cannot insert - Database already contains record with this key.
  180. 2032  Cannot insert - Empty Keys are not allowed.
  181. 2033  Cannot insert - A Boolean has not been set.
  182. 2034  Cannot create - Filename invalid or not specified.
  183. 2035  Cannot open/create - More than 10 Databases open.
  184. 2040  Specified file is not of ILBM format.
  185. 2041  Specified file is not of ANIM5 format.
  186. 2042  Specified file is not of 8SVX format.
  187. 2043  Specified file is not of SMUS format.
  188. 2044  Specified file is not an AmigaVision application.
  189. 2045  Specified file is not an ILBM or ANIM5 format.
  190. 2046  Specified file is not ASCII.
  191. 2048  Incompatible application file format.
  192. 2049  Value is not the correct type.
  193. 2050  Value is out of range.
  194. 2051  Value is invalid.
  195. 2053  Presentation error:  Could not open screen; aborting.
  196. 2055  Image output only possible on printer.
  197. 2056  Value cannot be negative.
  198. 2057  Field is Invalid.
  199. 2058  Number will not fit in field when properly formatted.
  200. 2059  Date is Invalid.
  201. 2060  Cannot initialize video player.  Please check player, cable, and settings.
  202. 2061  Filename & type is too long. (30 character maximum)
  203. 2062  Specified file is not an AmigaVision 'Display Object' file.
  204. 2063  Specified file is not of dBaseIII format.
  205. 2064  Cannot create Workbench icon file:  Filename is too long.
  206. 2065  Cannot create backup file:  Filename is too long.
  207. 2066  Backup file will not have a Workbench icon:  Filename is too long.
  208. 2067  Drawer & filename is too long. (255 character maximum)
  209. 2068  Drawer is too long. (255 character maximum)
  210. 2069  Filename & type may not contain the characters: /   \
  211. 2070  Command specified in Execute icon cannot be performed.
  212. 2071  Cannot find default tool for project in Execute icon.
  213. 2072  Illegal negative parameter: This function accepts positive values only.
  214. 2073  The second parameter must be greater in value than the first.
  215. 2074  Cannot open specified database
  216. 2075  Cannot delete record
  217. 2076  Database record must be selected before performing action
  218. 2080  Valid Timer units are 1..9 inclusive.
  219. 2081  Function does not accept input of zero (0).
  220. 2082  Parameter(s) outside of acceptable range.
  221. 2084  Cannot load file: it was created by a newer version of AmigaVision.
  222. 3001  Can't find Workbench 1.3 libraries
  223. 3002  No textfile specified.
  224. 3003  Cant open textfile.
  225. 3004  Bad chunk read
  226. 3005  Flowfile read error
  227. 4001  Unable to open file '%s'
  228. 4002  Not an IFF file '%s'
  229. 4003  Read Error
  230. 4004  Can't find instrument '%s'
  231. 4005  Bad Compress Type in '%s'
  232. 4006  Not enough memory
  233. 4007  Not a valid ANIM5 file '%s'
  234. 4010  Expression syntax error
  235. 4011  Can't open translator library
  236. 4012  Can't open narrator device
  237. 4013  An SMUS file is running
  238. 4014  Not a valid 8SVX file '%s'
  239. 4015  Too many sounds
  240. 4016  Can't open audio device
  241. 4017  Not a valid SMUS file '%s'
  242. 4018  Too many instruments
  243. 4019  Cache manager not running
  244. 4020  Unable to open desired screen
  245. 4021  Display object already in use
  246. 4022  Voice is active
  247. 4023  Serial device is busy
  248. 4024  Audio device is busy
  249. 4025  Timer device is busy
  250. 4026  SMUS file contains no instruments
  251. 4027  ILBM too deep
  252. 4028  Filename needed for 'File Defined' usage
  253. 4029  A Forms icon is already executing: second activation ignored.
  254. 4030  Current CD does not contain the track(s) specified.
  255. 4031  Invalid range specification for CD Audio play command.
  256. 4033  Not a valid ANIMBRUSH file '%s'
  257. 4035  Can't open camd.library.
  258. 4036  Can't open realtime.library.
  259.  
  260.